All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class quicktime.QTRuntimeException 

java.lang.Object
   |
   +----java.lang.Throwable
           |
           +----java.lang.Exception
                   |
                   +----java.lang.RuntimeException
                           |
                           +----quicktime.QTRuntimeException
public class QTRuntimeException
extends RuntimeException
QTRuntimeExceptions are thrown by the QTJava classes when an exceptional condition is caused that cannot be recovered from at runtime. This will usually occur within a java method (for eg. clone()) that has not API for throwing an exception. In the clone method for instance this exception is thrown if there is an out of memory condition.

Constructor Index

o QTRuntimeException(Exception)
Creates a QTRuntimeException
o QTRuntimeException(int)
Creates an QTRuntimeException with a message that could contain information that could be displayed to the user.
o QTRuntimeException(QTException)
Creates a QTRuntimeException
o QTRuntimeException(String)
Creates an QTRuntimeException with a message that could contain information that could be displayed to the user.

Method Index

o errorCode()
Return the error code that generated the exception.
o errorCodeToString()
Returns a string that represents the error code of the current QTException.
o handleOrThrow(QTRuntimeException, Object, String)
If there is a handler registered for the exception it will be passed to that handler.
o registerHandler(QTRuntimeHandler)
This registers an object that will handle the runtime Exceptions that may be generated through the (ab)normal running of a QTJava application or applet.
o toString()
Print current build information and current exception details.

Constructors

o QTRuntimeException 
 public QTRuntimeException(QTException e)
Creates a QTRuntimeException

Parameters:
e - the QTException that created the runtime error
o QTRuntimeException 
 public QTRuntimeException(Exception e)
Creates a QTRuntimeException

Parameters:
e - the Exception that created the runtime error
o QTRuntimeException 
 public QTRuntimeException(int val)
Creates an QTRuntimeException with a message that could contain information that could be displayed to the user.

Parameters:
val - typically some error code
o QTRuntimeException 
 public QTRuntimeException(String str)
Creates an QTRuntimeException with a message that could contain information that could be displayed to the user.

Parameters:
str - The message that could be displayed to the user

Methods

o handleOrThrow 
 public static void handleOrThrow(QTRuntimeException e,
                                  Object eGenerator,
                                  String methodNameIfKnown)
If there is a handler registered for the exception it will be passed to that handler. The handler should either deal with the exception or throw it - particularly if the exception is notified as a potentially serious exception - eg. memFullErr

Parameters:
e - the exception to either handle or throw
o registerHandler 
 public static void registerHandler(QTRuntimeHandler h)
This registers an object that will handle the runtime Exceptions that may be generated through the (ab)normal running of a QTJava application or applet.

Parameters:
h - the QTRuntimeHandler that will handle or throw QTRuntimeExceptions or null to remove handler.
o errorCode 
 public final int errorCode()
Return the error code that generated the exception. If there was no QT error code number known this value will be 0 in which case the message contains information about the exception.

Returns:
an int
o errorCodeToString 
 public String errorCodeToString()
Returns a string that represents the error code of the current QTException. This will return the name of the error code as represented in the quicmtime.Errors interface. If the error code is unknown then the string "Unknown Error Code" will be returned.

Returns:
a string that represents the current error code of the QTException.
o toString 
 public String toString()
Print current build information and current exception details.

Overrides:
toString in class Throwable 
All Packages  Class Hierarchy  This Package  Previous  Next  Index